home *** CD-ROM | disk | FTP | other *** search
/ Aminet 37 / Aminet 37 (2000)(Schatztruhe)[!][Jun 2000].iso / Aminet / util / moni / SnoopDos32_src.readme < prev    next >
Text File  |  2000-05-02  |  7KB  |  164 lines
  1. Short:    SnoopDos 3.2 sources for SAS/C
  2. Author:   ecarroll@maths.tcd.ie (Eddy Carroll) et al.
  3. Uploader: thor@math.tu-berlin.de (Thomas Richter)
  4. Type:     util/moni
  5.  
  6. _____________________________________________________________________________
  7.  
  8.                         SnoopDos 3.0 -- Source Code Release
  9.  
  10.            Copyright © Eddy Carroll, September 1994. Freely distributable.
  11.  
  12.            Updated by Luca Longone and Massimo Tantignone in January 2000.
  13.  
  14.        Updated by Grzegorz Chmie and Thomas Richter in March 2000.
  15.  
  16.  
  17. NOTE ABOUT THE 3.2 UPDATE
  18.  
  19.     This new update fixes one frequent hit I got when SnoopDos logged some
  20.     system calls while a second task was working on the layers. The
  21.     problem is that some graphics.library and rtg calls NULL the Rastport->
  22.     Layer field temporarely, and SnoopDos did not check before using this
  23.     pointer.
  24.     Additionally, the SnoopDos iconfication code did not work with "newicons"
  25.     which store their image data in an unorthogonal way. This was fixed by
  26.     Grzegorz Chmie, I used his code almost unchanged. Thanks!
  27.  
  28.     The file snoopdos.h has been enhanced to contain all exported functions
  29.     completely, to allow a clean recompile using the registerized parameters
  30.     model of SAS/C.
  31.  
  32.     Two obsolete amiga.lib calls, CreateExtIO() and DeleteExtIO() have been
  33.     replaced by their exec.library equivalence for orthogonality.
  34.     
  35.     All changes in the code have been marked by "THOR" so you may easely
  36.     identify my changes and additions.
  37.  
  38.     You can find the archive with the executable compiled from this source
  39.     code on Aminet (util/moni/snoopdos32.lha).
  40.  
  41.     For further questions, contact me at:
  42.  
  43.     thor@math.tu-berlin.de    (Thomas Richter)
  44.  
  45.  
  46. NOTE ABOUT THE 3.1 UPDATE
  47.  
  48.     This update removes an Enforcer hit which can happen with version 3.0
  49.     when a program is launched from ToolManager's dock and SnoopDos is
  50.     running with its "SendRexx" patch turned on. Said hit doesn't seem to
  51.     cause any harm, however it can be an annoyance for people which have
  52.     Enforcer running all the time.
  53.     The hit is apparently due to the way ToolManager sets up its message
  54.     port and only happens when SnoopDos 3.0 is running. Since we can't fix
  55.     ToolManager right now, we made SnoopDos able to avoid the hit, by adding
  56.     a safety check on the memory type at line 4466 in the "patches.c" module.
  57.  
  58.     The following files have been updated for this release:
  59.  
  60.     snooptext.h           snooptext.ct           snooptext.cd
  61.     SnoopDos.Roadmap      snoopdos.c             patches.c
  62.  
  63.     All files other than "patches.c" have been changed just to update the
  64.     version information; no changes were made to the actual code.
  65.  
  66.     You can find the archive with the executable compiled from this source
  67.     code on Aminet (util/moni/snoopdos31.lha).
  68.  
  69.     Note: references to PGP in the documentation aren't valid anymore for
  70.     SnoopDos versions greater than 3.0. If you need authentication, please
  71.     write to one of the following e-mail addresses:
  72.  
  73.     llong@tin.it, hexaae@tiscalinet.it (Luca Longone)
  74.     tanti@intercom.it (Massimo Tantignone)
  75.     ecarroll@iol.ie (Eddy Carroll)
  76.  
  77.     The rest of this file is unchanged from the original Readme.source file
  78.     as found in the SnoopDos 3.0 source code distribution.
  79.  
  80.  
  81. INTRODUCTION
  82.  
  83.     SnoopDos patches a variety of AmigaDOS library functions that
  84.     are commonly called by other programs and allows you to monitor
  85.     the activities carried out by those programs.
  86.  
  87.     The source code allows you to examine how SnoopDos operates. You
  88.     may find it useful as example code if you are interested in any
  89.     of the following:
  90.  
  91.       - patching system library functions
  92.       - creating font-sensitive gadtools or BOOPSI GUI interfaces
  93.         without the help of a third party GUI library
  94.       - accessing AmigaGuide help
  95.       - copying text to the clipboard
  96.       - allowing localisation of all program text strings
  97.       - supporting drag & drop operations
  98.       - seeing how a medium sized Amiga application is constructed
  99.  
  100.     I don't claim that this code is perfect but it does have the advantage
  101.     of actually working, so it's a useful starting point.
  102.  
  103.     You will probably also want to obtain the companion binary archive
  104.     snoopdos30.lha, available in the /pub/aminet/util/moni directory on
  105.     AmiNet. This contains the SnoopDos executable, and also an extensive
  106.     AmigaGuide help file which should prove useful while browsing the
  107.     source code.
  108.  
  109.     See the file SnoopDos.Roadmap inside the source directory for information
  110.     about how the source code is organised.
  111.  
  112.  
  113. DISTRIBUTION CONDITIONS
  114.  
  115.     You may freely use portions of the SnoopDos source code in your
  116.     own programs if you wish. However, if you use two or more complete
  117.     functions from the SnoopDos code, you must acknowledge the origin
  118.     of those functions in your documentation and source code.
  119.  
  120.     You may modify the SnoopDos source code to create new versions of
  121.     SnoopDos for your own use only. You may not redistribute such new
  122.     versions without my explicit permission.
  123.  
  124.  
  125. AUTHOR
  126.  
  127.     You can contact the author at:
  128.  
  129.         ecarroll@maths.tcd.ie
  130.         ecarroll@cix.compulink.co.uk
  131.  
  132.  
  133. ============================= Archive contents =============================
  134.  
  135. Original  Packed Ratio    Date     Time    Name
  136. -------- ------- ----- --------- --------  -------------
  137.     4970    2252 54.6% 05-Mar-00 23:39:34  Readme.source
  138.    45174   11785 73.9% 05-Mar-00 23:13:12 +buffer.c
  139.     2623    1094 58.2% 05-Mar-00 23:13:18 +gui.h
  140.    18349    4747 74.1% 05-Mar-00 23:13:12 +hotkey.c
  141.     3453    1303 62.2% 05-Mar-00 23:13:18 +icon.h
  142.     2612    1200 54.0% 05-Mar-00 23:13:12 +language.c
  143.   248758   53304 78.5% 05-Mar-00 23:13:12 +mainwin.c
  144.     2555     925 63.7% 05-Mar-00 23:14:38 +makefile
  145.    32871   11418 65.2% 05-Mar-00 23:13:12 +miscwin.c
  146.     5168    2163 58.1% 17-Sep-94 18:08:40 +patchcode.s
  147.   208083   45822 77.9% 05-Mar-00 23:13:12 +patches.c
  148.     3792    1144 69.8% 05-Mar-00 23:13:18 +patches.h
  149.       97      83 14.4% 05-Mar-00 23:28:06 +Project-Startup
  150.      312     189 39.4% 05-Mar-00 23:13:22 +scoptions
  151.    52242   17282 66.9% 05-Mar-00 23:13:12 +settings.c
  152.    21097    5015 76.2% 05-Mar-00 23:13:12 +snoopdos.c
  153.    63976   15608 75.6% 05-Mar-00 23:13:18 +snoopdos.h
  154.    21021    7900 62.4% 05-Mar-00 23:31:06 +SnoopDos.Roadmap
  155.    19179    6820 64.4% 12-Jan-00 19:28:54 +snooptext.cd
  156.    14162    5182 63.4% 12-Jan-00 19:47:24 +snooptext.ct
  157.    76408   15781 79.3% 05-Mar-00 23:13:18 +snooptext.h
  158.   184820   37682 79.6% 05-Mar-00 23:13:12 +subwin.c
  159.      280     192 31.4% 05-Mar-00 23:13:12 +system.c
  160.     1956     523 73.2% 05-Mar-00 23:13:18 +system.h
  161.    10709    3032 71.6% 05-Mar-00 23:13:12 +testcalls.c
  162. -------- ------- ----- --------- --------
  163.  1044667  252446 75.8% 07-Mar-100 11:38:58   25 files
  164.